home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / filutil / carve20a.zip / CARVE20A.DOC < prev    next >
Text File  |  1995-04-17  |  5KB  |  152 lines
  1.     ========================================================================
  2.                                    
  3.                                    CARVE v2.0a
  4.                         Copyright(c) 1995  Graeme J Scott
  5.  
  6.     ========================================================================
  7.  
  8.  
  9. Disclaimer
  10. ----------
  11.  
  12. CARVE is distributed "as is". The author of this program makes no warranty,
  13. expressed or implied, as to the merchantability or fitness for a particular
  14. purpose, with respect to this software and documentation. The author will not
  15. be held liable for any damages arising from the (mis)use of this program.
  16.  
  17.  
  18. Distribution
  19. ------------
  20.  
  21. This program is freeware and may be freely distributed as long as :-
  22.  
  23. i)   The executable: CARVE.EXE, documentation: CARVE20A.DOC,
  24.      description file: FILE_ID.DIZ and archive info: FILES.LST are included
  25.      together in any archive. Do not distribute any of these files without
  26.      *all* the others.
  27.  
  28. ii)  No money is charged other than for copying and media costs, if
  29.      applicable.
  30.  
  31. iii) No changes are made to either the program or the documentation, without
  32.      the prior permission of the author.
  33.  
  34.  
  35. What is Carve?
  36. --------------
  37.  
  38. Carve is a simple little utility that will split a file into a specified number
  39. of 'chunks', and join them back together again. Maybe it's just me, but it
  40. seems a bit of an oversight on the part of Microsoft that there is no split or
  41. join commands in MS-DOS (although there is a pseudo join command using
  42. COPY /b file1 + file2 + file3 + fileX outfile).
  43.  
  44.  
  45. Using Carve
  46. -----------
  47.  
  48. Using it couldn't be easier. There are 2 modes of operation:-
  49.  
  50. To split:
  51.  
  52. CARVE /s <filename> <chunksize[k]> [output directory]
  53.  
  54. Where filename is the name of any file that you want to split (no wildcards).
  55. This file can be anything at all, text, exe, zip, whatever you like.
  56.  
  57. Chunksize is the size, in bytes (unless K is specified) that you want each 
  58. chunk to be. The lowest value is 1 byte  and the largest is 32768 kilobytes.
  59. The size must be specified as an integer (a 'whole' number). Also, remember
  60. that 1Kb is actually 1024 bytes, not 1000! 
  61.  
  62. Output directory is optional. If none is specified, the output will go to the
  63. current directory.
  64.  
  65. The name of each split part of a file called DEMO.TXT, for example, will be
  66. named DEMO.001 for the 1st part, DEMO.002 for the 2nd part etc, etc. Obviously,
  67. since it's only the file extension that differs in the names of each part
  68. (i.e. 3 characters), you can only have a maximum of 999 parts.
  69.  
  70. To join:
  71.  
  72. CARVE /j <filename> [output directory]
  73.  
  74. Where filename is the name of the file that you want to rebuild from the
  75. previously split chunks. Again, the output directory is optional.
  76.  
  77.  
  78. Examples
  79. --------
  80.  
  81. To join the files TEXT.001, TEXT.002 and TEXT.003 to rebuild the file TEXT.TXT,
  82. and put it in the current directory:
  83.  
  84. CARVE /j TEXT.TXT
  85.  
  86.  
  87. To split the file HUGE.ZIP into 50 Kilobyte chunks:
  88.  
  89. CARVE /s HUGE.ZIP 50K
  90. or
  91. CARVE /s HUGE.ZIP 51200                          (51200 bytes = 50 kilobytes)
  92.  
  93.  
  94. To split the file TEST.CPP into 500 byte chunks and put them into C:\SOURCE
  95.  
  96. CARVE /s TEST.CPP C:\SOURCE
  97.  
  98.  
  99. History
  100. -------
  101.  
  102. v2.0a   Complete rewrite of code due to loss of all previous versions :(
  103.         Should be no more problems with 0 byte joined files. New features
  104.         include: percentage counter, split files into as little as 1 byte
  105.         (rather than 1K), slight speed improvement on most drives, and
  106.         definable output directories.
  107.  
  108. v1.2    Modified v1.1 to allow joining of files. No other changes.
  109.  
  110. v1.1    First version publically available. Splits files to definable sized
  111.         parts. Improved dynamic buffer allocation for much improved speed.
  112.  
  113. v1.0    Never generally released.
  114.  
  115.  
  116. Credits
  117. -------
  118.  
  119. Thanks must go to all the people who reported the problems with the previous
  120. version of CARVE (v1.2). Special thanks for beta testing go to -
  121.  
  122. Steve Cuddy (cuddy@gaul.csd.uwo.ca)
  123. David Kmoch (kmoch@bubo.vslib.cz)
  124. Steve Holm  (sholm@teleport.com)
  125.  
  126. Thanks guys.
  127.  
  128.  
  129. Last words
  130. ----------
  131.  
  132. Hopefully I've managed to exterminate all the bugs that dogged the previous
  133. release. However, if you need to contact me for any reason, bug reports,
  134. comments etc. I can be e-mailed at:- 
  135.  
  136. graemes@festival.ed.ac.uk     or
  137. bsc2110@dcs.napier.ac.uk
  138.  
  139.  
  140. Keep an eye out for
  141. -------------------
  142.  
  143. Look out for HexManager v1.0 (hexman10.zip), an excellent hex editor available 
  144. to download by anonymous ftp from :-
  145.  
  146. src.doc.ic.ac.uk     /pub/computing/systems/ibmpc/simtel/binedit     (UK)
  147. oak.oakland.edu      /pub/binedit                                    (USA)
  148. garbo.uwasa.fi       /pc/demo                                        (Finland)
  149.  
  150.  
  151.     ==================================EOF===================================
  152.